home *** CD-ROM | disk | FTP | other *** search
/ Chip 2007 January, February, March & April / Chip-Cover-CD-2007-02.iso / Pakiet bezpieczenstwa / mini Pentoo LiveCD 2006.1 / mpentoo-2006.1.iso / livecd.squashfs / usr / lib / mozilla-firefox / idl / nsIWindowCreator2.idl < prev    next >
Text File  |  2006-05-08  |  4KB  |  94 lines
  1. /* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*-
  2.  *
  3.  * ***** BEGIN LICENSE BLOCK *****
  4.  * Version: MPL 1.1/GPL 2.0/LGPL 2.1
  5.  *
  6.  * The contents of this file are subject to the Mozilla Public License Version
  7.  * 1.1 (the "License"); you may not use this file except in compliance with
  8.  * the License. You may obtain a copy of the License at
  9.  * http://www.mozilla.org/MPL/
  10.  *
  11.  * Software distributed under the License is distributed on an "AS IS" basis,
  12.  * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
  13.  * for the specific language governing rights and limitations under the
  14.  * License.
  15.  *
  16.  * The Original Code is mozilla.org code.
  17.  *
  18.  * The Initial Developer of the Original Code is
  19.  * Netscape Communications, Inc.
  20.  * Portions created by the Initial Developer are Copyright (C) 2001
  21.  * the Initial Developer. All Rights Reserved.
  22.  *
  23.  * Contributor(s):
  24.  *
  25.  * Alternatively, the contents of this file may be used under the terms of
  26.  * either the GNU General Public License Version 2 or later (the "GPL"), or
  27.  * the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
  28.  * in which case the provisions of the GPL or the LGPL are applicable instead
  29.  * of those above. If you wish to allow use of your version of this file only
  30.  * under the terms of either the GPL or the LGPL, and not to allow others to
  31.  * use your version of this file under the terms of the MPL, indicate your
  32.  * decision by deleting the provisions above and replace them with the notice
  33.  * and other provisions required by the GPL or the LGPL. If you do not delete
  34.  * the provisions above, a recipient may use your version of this file under
  35.  * the terms of any one of the MPL, the GPL or the LGPL.
  36.  *
  37.  * ***** END LICENSE BLOCK ***** */
  38.  
  39. /**
  40.  * nsIWindowCreator2 is an extension of nsIWindowCreator which allows
  41.  * additional information about the context of the window creation to
  42.  * be passed.
  43.  *
  44.  * @see nsIWindowCreator
  45.  * @see nsIWindowWatcher
  46.  *
  47.  * @status
  48.  */
  49.  
  50. #include "nsIWindowCreator.idl"
  51.  
  52. interface nsIURI;
  53. interface nsIWebBrowserChrome;
  54.  
  55. // This interface is not generally scriptable: only the const(s)
  56. // should be visible.
  57. [scriptable, uuid(f673ec81-a4b0-11d6-964b-eb5a2bf216fc)]
  58.  
  59. interface nsIWindowCreator2 : nsIWindowCreator {
  60.  
  61.   /**
  62.    * Definitions for contextFlags
  63.    */
  64.  
  65.   // Likely that the window is an advertising popup. 
  66.   const unsigned long PARENT_IS_LOADING_OR_RUNNING_TIMEOUT = 0x00000001;
  67.  
  68.   /** Create a new window. Gecko will/may call this method, if made
  69.       available to it, to create new windows.
  70.       @param parent Parent window, if any. Null if not. The newly created
  71.                     window should be made a child/dependent window of
  72.                     the parent, if any (and if the concept applies
  73.                     to the underlying OS).
  74.       @param chromeFlags Chrome features from nsIWebBrowserChrome
  75.       @param contextFlags Flags about the context of the window being created.
  76.       @param uri The URL for which this window is intended. It can be null
  77.                  or zero-length. The implementation of this interface
  78.                  may use the URL to help determine what sort of window
  79.                  to open or whether to cancel window creation. It will not
  80.                  load the URL.
  81.       @param cancel Return |true| to reject window creation. If true the
  82.                     implementation has determined the window should not
  83.                     be created at all. The caller should not default
  84.                     to any possible backup scheme for creating the window.
  85.       @return the new window. Will be null if canceled or an error occurred.
  86.   */
  87.   [noscript]
  88.   nsIWebBrowserChrome createChromeWindow2(in nsIWebBrowserChrome parent,
  89.                                           in PRUint32 chromeFlags,
  90.                                           in PRUint32 contextFlags,
  91.                                           in nsIURI uri,
  92.                                           out boolean cancel);
  93. };
  94.